======[tutoriel]OpenNI et NITE ======


===== Pré-requis =====

<note help>  * NITE permet d'utiliser les fonctionc de **HandTracking** (reconnaissance des mains et suivi) et **Skeleton tracking** (reconnaissance du corp et suivi des membres) avec la Kinect sur Ubuntu.
  * NITE est édité par [[http://www.primesense.com|PrimeSense]] et distribué par [[http://www.openni.org|OpenNI]].
  * Ce tutoriel concerne NITE en version 1.3.0.17 pour Ubuntu 10.10.
  * Ce middleware (NITE) est sous licence son libre (Les termes de l'usage même de ce produit, sont assez flous), c'est pourquoi aucun lien pour le téléchargement de NITE porposé sur cette page.
</note>

<note important>Assurez vous d'avoir correctement réalisé les étapes du ce [[http://doc.ubuntu-fr.org/kinect_openni|tutoriel]] avant d'installer NITE de cette manière</note>

<note help>Sources : 
  * Ce [[http://upinstall.passion-xbmc.org/tutoriels-linux/installation-kinect-openni-nite/|tutoriel]] sur le forum **Passion XBMC**
  * ce [[http://www.keyboardmods.com/2010/12/howto-kinect-openninite-skeleton.html|tutoriel]] **(En anglais)**, sur **Keyboardmods**
  * Le [[http://wiki.openni.org/mediawiki/index.php/Main_Page|wiki]] **(En anglais)**
</note>


===== Installation de NITE =====

Une fois le fichier **NITE-Bin-Ubuntu-x86-1.3.0.17.tar.bz2** (pour le 32 bits, ou **NITE-Bin-Ubuntu-x64-1.3.0.17.tar.bz2** pour le 64 bits) récupéré :
<code>cd ~/kinect/</code>
<code>mkdir NITE</code>
<code>cd NITE</code>

Extraction :
    * Pour le fichier 32 bits : <code>tar -xjf NITE-Bin-Ubuntu-x86-1.3.0.17.tar.bz2</code>

    * ou pour le fichier 64 bits : <code>tar -xjf NITE-Bin-Ubuntu-x64-1.3.0.17.tar.bz2</code>


Modification des fichiers de config .xml (**Sample-Scene.xml**, **Sample-Tracking.xml** et **Sample-User.xml**) :
<code>cd ~/kinect/NITE/Nite-1.3.0.17/Data</code>
<code>sudo gedit *.xml</code>

Pour les 3 fichiers
    * Substituer < MapOutputMode xRes="**320**" yRes="**240**" FPS="30"/>
Par < MapOutputMode xRes="**640**" yRes="**480**" FPS="30"/>
    * Substituer < License vendor="PrimeSense" key="**insert key here**"/>
Par < License vendor="PrimeSense" key="**0KOIk2JeIBYClPWVnMoRKn5cdY4=**"/>


Puis
<code>sudo niLicense PrimeSense 0KOIk2JeIBYClPWVnMoRKn5cdY4=</code>
<code>cd ~/kinect/NITE/Nite-1.3.0.17/</code>


Et Installation via le script
<code>sudo ./install.bash</code>


Saisir la clef **0KOIk2JeIBYClPWVnMoRKn5cdY4=** quand demandée


===== Usage de Nite =====

Placer vous dans le répertoire des exécutables fraichement compilés
<code>cd ~/kinect/NITE/Nite-1.3.0.17/Samples/Bin</code>

=== Test / Calibration ===

    * **Sample-PointViewer**<code>sudo ./Sample-PointViewer</code>

Pour test le **HandTracking** avec 2 mains :
<code>sudo gedit /usr/etc/primesense/XnVHandGenerator/Nite.ini</code>
Dé-commentez les 2 lignes sous **[HandTrackerManager]** (supprimer le "**;**" au début de chaque ligne), puis relancez **Sample-PointViewer**

    * **Sample-Players**<code>sudo ./Sample-Players</code>
<note tip>    * La kinect doit pouvoir vous voir debout en entier (de la tête aux pieds) et pour initialiser la calibration (et la reconnaissance du squelette), vous devez vous tenir de face avec les bras à l'horizontale avec les avant bras repliés vers le haut.
    * Une fois la pause correcte, déclenchant la calibration vous verrez **Calibration started** sur cotre console et les informations relevées pendant la calibration
    * Les mesures de calibration ne semblent pas persistantes.
</note>


{{tag>maverick système tutoriel Kinect BROUILLON}}
